home *** CD-ROM | disk | FTP | other *** search
/ Just Call Me Internet / Just Call Me Internet.iso / prog / atari / c / mail110 / mailer.doc < prev    next >
Text File  |  1994-02-19  |  6KB  |  202 lines
  1. MAILER.TOS    Version 1.9  16 February 1994
  2. ==========
  3.  
  4. This is a simple mailer for use with NOS and the Demon Internet Service.
  5.  
  6. This program is Copyright (c) 1994, G B Judd and is offered under the
  7. conditions of the FSF Copyleft scheme.  See the file copying.fsf for
  8. more details.
  9.  
  10. It is a lookalike for another mailer, BM, which had no source and had the
  11. paths to the varius directories hard-coded.  I did not like this so I put
  12. this simple program together.
  13.  
  14. This program uses a startup file, MAILER.RC, which contains various bits of
  15. information.  See below for an example.  This file must be in the NOS_ROOT
  16. directory.
  17.  
  18. The program relies upon the normal NOS directory structures, so, if your
  19. SPOOL directory is in C:\NOS\, the the program expects to find the following:
  20.  
  21. C:\NOS\SPOOL\MAIL\                     The directory containing the mailboxes.
  22. C:\NOS\SPOOL\MQUEUE\                   The directory for outbound mail.
  23. C:\NOS\SPOOL\MQUEUE\SEQUENCE.SEQ       The mailer sequence file.
  24. C:\NOS\MAILER.RC                       The mailer startup file.
  25.  
  26. Many thanks to Alec Jones    ajonesf@cix.compulink.co.uk, 
  27.                 ajones@rhune.demon.co.uk
  28. for supplying the module to save ougoing mail in your specified log file.
  29.  
  30.  
  31. COMMANDS
  32. ========
  33.  
  34. m user        Send mail to a user, you specify the full mail address for
  35.         the user.
  36.             m gjudd@siward.demon.co.uk
  37.  
  38. t user file    Send mail to a user, with the body of the mail item taken
  39.         from the specified file.
  40.             t gjudd@siward.demon.co.uk c:\fred.txt
  41.  
  42. f user [999]    Forward a message to another user.  If the message number is
  43.         not given, forward the current message.
  44.             f gjudd@siward.demon.co.uk
  45.             f gjudd@siward.demon.co.uk 4
  46.  
  47. r [999]        Reply to a message.  If the message number is not given,
  48.         reply to the current message.
  49.             r 32
  50.             r
  51.  
  52. ENTER        Read the next unread message.
  53.  
  54. 999        Read the specified message.  Set the current message pointer
  55.         to the message number.
  56.             21
  57.  
  58. p [999]        Read the specified message.  If the message number is not
  59.         given, read the current message.  Sets the current message
  60.         to the number given.
  61.             p 17
  62.             p
  63.  
  64. s [file]    Save the current message to a file.  If the file is not given,
  65.         the message is appended to mbox.txt.  The message is saved
  66.         with all of the header information.
  67.             s f:\gbj.txt
  68.             s
  69.  
  70. w [file]    Same as save except the header information is not saved, just
  71.         the message body.
  72.             w f:\gbj.txt
  73.             w
  74.  
  75. d [999]        Mark the specified message for deletion.  The deletion is not
  76.         performed until you exit with the 'q' command.  If the
  77.         message number is not given, mark the current message.  
  78.         See the note about the 'n' command below.
  79.             d 23
  80.             d
  81.  
  82. u [999]        Unmark a previously marked for deletion message.  This is the
  83.         converse of the 'd' command.
  84.             u 23
  85.             u
  86.  
  87. +        Set the current message pointer to the next message.  This
  88.         does not show the message to you.
  89.  
  90. -        Set the current message pointer to the previous message.
  91.         This does not show the message to you.
  92.  
  93. h [999]        Show the message index from the specified message number.
  94.         If you do not specify a message number, the index is shown
  95.         from the current message -8 to the current message +8.
  96.             h 0
  97.             h
  98.  
  99. l        List unsent message files held in the MQUEUE directory.
  100.         All this does is show a list of file names at the moment.
  101.         
  102. n mbox        Change from the current mailbox to another one.  Note, the
  103.         action of changing mailboxes is equivalent to using the
  104.         'x' command and then loading the new mailbox.  In particular,
  105.         this means that the current mailbox will not have its status
  106.         updated.
  107.             n gjudd
  108.  
  109. x        Exit, do not update any messages statuses.  The effect is to
  110.         leave the message with the status they had when you ran the
  111.         program.
  112.  
  113. q        Exit, udate statuses.  The will remove deleted messages from
  114.         the mailbox and retain the read/unread status for other
  115.         messages.
  116.  
  117. ?        Display a command summary.
  118.  
  119.  
  120.  
  121. ENTER        The ENTER/RETURN key.
  122. []        Indicates optional arguments.
  123. 999        Indicates a numeric argument.
  124. mbox        Indicates a mailbox name, i.e., gjudd, which is found in
  125.         ...\SPOOL\MAIL\gjudd.txt
  126.  
  127.  
  128. INDEX DISPLAY
  129. =============
  130.  
  131. The mailbox index display appears as follows:
  132.  
  133. >ab 999 Sender  Date  Subject
  134.  
  135. The current message is indicated in reverse video.
  136.  
  137. ab indicate read and delete flags, Y=read, D=marked for deletion.
  138.  
  139.  
  140.  
  141. MAILER.RC
  142. =========
  143.  
  144. Here is a sample mailer.rc file, it is my one...
  145.  
  146. # Start of mailer.rc
  147. #
  148. # configuration file for 'mailer', G B Judd's simple mailer for ka9q
  149. #
  150. #    host    =    this_host_name
  151. #    user     =    this_user_name
  152. #    name     =    your full name for mail headers
  153. #    reply     =    your reply address
  154. #    mail    =     path to directory containing 'mail' and 'mqueue'
  155. #            directories
  156. #    edit    =    path your editor
  157. #    sig    =    path to your signature file [optional]
  158. #    log    =    file name of your outgoing mail log file [optional],
  159. #            resides in your 'mail' directory.
  160. #
  161. # The format must be <keyword>=<value>
  162. #    There must be no space around the '=' sign
  163. #    Comments can be included and are indicated by a '#' as the
  164. #    very first character of a line.  You can also have completely
  165. #    blank lines.
  166.  
  167. host=siward.demon.co.uk
  168. user=gjudd
  169. name=Graham Judd
  170. reply=gjudd@siward.demon.co.uk
  171. mail=d:\spool
  172. edit=c:\editors\emacs\emacs.prg
  173. sig=d:\gjudd.sig
  174. log=outmail.txt
  175.     
  176. #End of mailer.rc
  177.  
  178.  
  179.  
  180. FINALLY
  181. =======
  182.  
  183. And that is about it except for me to say that this program, and its sources
  184. are in the Public Domain as Freeware.  You can do what you like with it as
  185. long as you retain the comments in mailer.h.
  186.  
  187. Bug reports should be sent to     gjudd@siward.demon.co.uk  (preferred)
  188.                 gjudd@cix.compulink.co.uk
  189.  
  190. If you make significant changes I will be pleased to received a copy.
  191.  
  192. NOTE:    this program is supplied "as is" with no warranty expressed or
  193.     implied.  YOU USE IT AT YOUR OWN RISK AND I ACCEPT NO RESPONSIBILITY
  194.     FOR ITS USE OR MISUSE.
  195.  
  196. That aside, I hope you find it useful.
  197.  
  198. Graham Judd
  199. gjudd@siward.demon.co.uk
  200. gjudd@cix.compulink.co.uk
  201.  
  202.